package com.kkb.dao;

import com.kkb.bean.Express;
import com.kkb.bean.RankingExpress;
import com.kkb.exception.DuplicateCodeException;

import java.util.List;
import java.util.Map;

public interface BaseExpressDao {
    /**
     * 用于查询数据库中的全部快递（总数+新增），待取件快递（总数+新增）
     * @return [{size：总数，day：新增},{size:总数，day新增}]
     */
    public List<Map<String , Integer>> console();

    /**
     * 用于查询所有快递
     * @param limit 标志是否分页，true表示分页，false表示查询所有快递
     * @param offset SQL语句的其实索引
     * @param pageNumber 页的数据条数
     * @return 快递的集合
     */
    public List<Express> findAll(boolean limit,int offset,int pageNumber);

    /**
     * 根据快递单号，查询快递信息
     * @param number 单号
     * @return 查询到的快递信息，取件码不存在是返回null
     */
    public Express findByNumber(String number);

    /**
     * 根据取件码，查询快递信息
     * @param code 取件码
     * @return 查询到的快递信息，取件码不存在是返回null
     */
    public Express findByCode(String code);

    /**
     * 根据手机号，查询快递信息
     * @param phoneNumber 手机号
     * @return 查询到的一些快递信息，手机号不存在是返回null
     */
    public List<Express> findByPhoneNumber(String phoneNumber);

    /**
     * 根据录入人的手机号，查询录入的所有快递信息
     * @param sysPhone 手机号
     * @return 查询快递信息列表
     */
    public List<Express> findBySysPhone(String sysPhone);

   /* *//**
     * 根据取件的数量，对人员进行排名
     * @return
     *//*
    public List<Express> lazyboard();*/

    /**
     * 快读的录入
     * @param e 要录入的快递对象
     * @return 录入的结果，true 表示成功，false 表示失败
     */
    public boolean insert(Express e) throws DuplicateCodeException;

    /**
     * 快读的录入
     * @param id 要修改的快递id
     * @param newExpress 新的快递对象（number，company，username，userPhone）
     * @return 录入的结果，true 表示成功，false 表示失败
     */
    public boolean update(int id,Express newExpress);

    /**
     * 修改快递的状态为1 ，表示快递被取出
     * @param code  取件码
     * @return 修改的结果，true 表示成功，false 表示失败
     */
    public boolean updateStatus(String code);


    /**
     * 根据id，删除单个快递
     * @param id 要删除快递的id
     * @return 删除结果，true表示成功，false表示失败
     */
    public boolean delete(int id);

    /**
     * 查询用户未取件的快递列表
     * @return 用户未取件的快递列表
     */
    public List<Express> findByPhoneAndStatus(String userPhone,int stutus);

    /**
     * 判断 快递单号是否存在
     * @param number 单号
     * @return 存在返回true ，不存在返false
     */
    public boolean isOneNumber(String number);

    /**
     * 根据 用户的快递数量来排行总
     *
     * @return 保存排行榜list
     */
    public List<RankingExpress> rankingByAll();

    /**
     * 根据 用户的快递数量来排行按年
     *
     * @return 保存排行榜list
     */
    public List<RankingExpress> rankingByYear();

    /**
     * 根据 用户的快递数量来排行按月
     *
     * @return 保存排行榜list
     */
    public List<RankingExpress> rankingByMonth();

}
